<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <meta name="generator" content="pandoc">
  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
  <meta name="description" content="Markdown Slides [ES]">
  <meta name="author" content="Adolfo Sanz De Diego">
  <title>Markdown Slides [ES]</title>
  <style type="text/css">code{white-space: pre; background-color: lightgrey;}</style>
  <style type="text/css">
div.sourceCode { overflow-x: auto; }
table.sourceCode, tr.sourceCode, td.lineNumbers, td.sourceCode {
  margin: 0; padding: 0; vertical-align: baseline; border: none; }
table.sourceCode { width: 100%; line-height: 100%; background-color: #f8f8f8; }
td.lineNumbers { text-align: right; padding-right: 4px; padding-left: 4px; color: #aaaaaa; border-right: 1px solid #aaaaaa; }
td.sourceCode { padding-left: 5px; }
pre, code { background-color: #f8f8f8; }
code > span.kw { color: #204a87; font-weight: bold; } /* Keyword */
code > span.dt { color: #204a87; } /* DataType */
code > span.dv { color: #0000cf; } /* DecVal */
code > span.bn { color: #0000cf; } /* BaseN */
code > span.fl { color: #0000cf; } /* Float */
code > span.ch { color: #4e9a06; } /* Char */
code > span.st { color: #4e9a06; } /* String */
code > span.co { color: #8f5902; font-style: italic; } /* Comment */
code > span.ot { color: #8f5902; } /* Other */
code > span.al { color: #ef2929; } /* Alert */
code > span.fu { color: #000000; } /* Function */
code > span.er { color: #a40000; font-weight: bold; } /* Error */
code > span.wa { color: #8f5902; font-weight: bold; font-style: italic; } /* Warning */
code > span.cn { color: #000000; } /* Constant */
code > span.sc { color: #000000; } /* SpecialChar */
code > span.vs { color: #4e9a06; } /* VerbatimString */
code > span.ss { color: #4e9a06; } /* SpecialString */
code > span.im { } /* Import */
code > span.va { color: #000000; } /* Variable */
code > span.cf { color: #204a87; font-weight: bold; } /* ControlFlow */
code > span.op { color: #ce5c00; font-weight: bold; } /* Operator */
code > span.pp { color: #8f5902; font-style: italic; } /* Preprocessor */
code > span.ex { } /* Extension */
code > span.at { color: #c4a000; } /* Attribute */
code > span.do { color: #8f5902; font-weight: bold; font-style: italic; } /* Documentation */
code > span.an { color: #8f5902; font-weight: bold; font-style: italic; } /* Annotation */
code > span.cv { color: #8f5902; font-weight: bold; font-style: italic; } /* CommentVar */
code > span.in { color: #8f5902; font-weight: bold; font-style: italic; } /* Information */
  </style>
  <!--[if lt IE 9]>
    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
  <![endif]-->
</head>
<body>
<header>
<h1 class="title">Markdown Slides [ES]</h1>
<p class="author">Adolfo Sanz De Diego</p>
<p class="date">Septiembre 2019</p>
</header>
<nav id="TOC">
<ul>
<li><a href="#acerca-de"><span class="toc-section-number">1</span> Acerca de</a><ul>
<li><a href="#qué-es-esto"><span class="toc-section-number">1.1</span> ¿Qué es esto?</a></li>
<li><a href="#ejemplos"><span class="toc-section-number">1.2</span> Ejemplos</a></li>
<li><a href="#colaboradores"><span class="toc-section-number">1.3</span> Colaboradores</a></li>
<li><a href="#licencia"><span class="toc-section-number">1.4</span> Licencia</a></li>
</ul></li>
<li><a href="#instalación"><span class="toc-section-number">2</span> Instalación</a><ul>
<li><a href="#dependencias"><span class="toc-section-number">2.1</span> Dependencias</a></li>
<li><a href="#requisitos"><span class="toc-section-number">2.2</span> Requisitos</a></li>
<li><a href="#descarga"><span class="toc-section-number">2.3</span> Descarga</a></li>
<li><a href="#docker"><span class="toc-section-number">2.4</span> Docker</a><ul>
<li><a href="#construir-la-imagen"><span class="toc-section-number">2.4.1</span> Construir la imagen</a></li>
<li><a href="#lanzar-el-contenedor"><span class="toc-section-number">2.4.2</span> Lanzar el contenedor</a></li>
</ul></li>
</ul></li>
<li><a href="#manejo"><span class="toc-section-number">3</span> Manejo</a><ul>
<li><a href="#creación"><span class="toc-section-number">3.1</span> Creación</a></li>
<li><a href="#notas"><span class="toc-section-number">3.2</span> Notas</a></li>
<li><a href="#niveles"><span class="toc-section-number">3.3</span> Niveles</a></li>
<li><a href="#numeración"><span class="toc-section-number">3.4</span> Numeración</a></li>
<li><a href="#configuración"><span class="toc-section-number">3.5</span> Configuración</a></li>
<li><a href="#generación"><span class="toc-section-number">3.6</span> Generación</a></li>
</ul></li>
<li><a href="#releases-notes"><span class="toc-section-number">4</span> Releases notes</a><ul>
<li><a href="#relese-1.0"><span class="toc-section-number">4.1</span> Relese 1.0</a></li>
<li><a href="#relese-2.0"><span class="toc-section-number">4.2</span> Relese 2.0</a></li>
<li><a href="#relese-3.0"><span class="toc-section-number">4.3</span> Relese 3.0</a></li>
</ul></li>
<li><a href="#autor"><span class="toc-section-number">5</span> Autor</a><ul>
<li><a href="#adolfo-sanz-de-diego"><span class="toc-section-number">5.1</span> Adolfo Sanz De Diego</a></li>
<li><a href="#algunos-proyectos"><span class="toc-section-number">5.2</span> Algunos proyectos</a></li>
<li><a href="#donde-encontrarme"><span class="toc-section-number">5.3</span> ¿Donde encontrarme?</a></li>
</ul></li>
</ul>
</nav>
<h1 id="acerca-de"><span class="header-section-number">1</span> Acerca de</h1>
<h2 id="qué-es-esto"><span class="header-section-number">1.1</span> ¿Qué es esto?</h2>
<p><strong>MarkdownSlides</strong> es un generador de <strong>slides</strong> Reveal.js y PDF a <strong>partir de ficheros MARKDOWN</strong>, que también genera documentos HTML, EPUB y DOCX.</p>
<p>La idea es que <strong>a partir de un mismo fichero MARKDOWN podamos obtener slides y libros</strong> sin preocuparnos por el estilo, solo por el contenido.</p>
<hr />
<figure>
<img src="../img/markdownslides.png" text-align="center" style="width:80.0%" />
</figure>
<h2 id="ejemplos"><span class="header-section-number">1.2</span> Ejemplos</h2>
<p>A partir de un fichero <a href="https://raw.github.com/asanzdiego/markdownslides/master/doc/md/leeme.md">MARKDOWN</a> genera:</p>
<ul>
<li><a href="http://asanzdiego.github.io/markdownslides/doc/export/leeme-reveal-slides.html">reveal-slides</a></li>
<li><a href="http://asanzdiego.github.io/markdownslides/doc/export/leeme-reveal-slides.pdf">reveal-slides-pdf</a></li>
<li><a href="http://asanzdiego.github.io/markdownslides/doc/export/leeme-book.epub">epub-book</a></li>
<li><a href="http://asanzdiego.github.io/markdownslides/doc/export/leeme-book.html">html-book</a></li>
<li><a href="http://asanzdiego.github.io/markdownslides/doc/export/leeme-book.docx">docx-book</a></li>
</ul>
<h2 id="colaboradores"><span class="header-section-number">1.3</span> Colaboradores</h2>
<ul>
<li>Cesar Seoane: <a href="https://github.com/cesarseoane" class="uri">https://github.com/cesarseoane</a></li>
<li>Rubén Gómez García: <a href="https://github.com/kaneproject" class="uri">https://github.com/kaneproject</a></li>
<li>Raul Jimenez Ortega: <a href="https://github.com/hhkaos" class="uri">https://github.com/hhkaos</a></li>
</ul>
<h2 id="licencia"><span class="header-section-number">1.4</span> Licencia</h2>
<blockquote>
<ul>
<li><strong>Este obra está bajo una licencia:</strong>
<ul>
<li><a href="http://creativecommons.org/licenses/by-sa/3.0/es/">Creative Commons Reconocimiento-CompartirIgual 3.0</a></li>
</ul></li>
<li><strong>El código fuente de los programas están bajo una licencia:</strong>
<ul>
<li><a href="http://www.viti.es/gnu/licenses/gpl.html">GPL 3.0</a></li>
</ul></li>
</ul>
</blockquote>
<h1 id="instalación"><span class="header-section-number">2</span> Instalación</h1>
<h2 id="dependencias"><span class="header-section-number">2.1</span> Dependencias</h2>
<ul>
<li>Necesita ser instalado:
<ul>
<li><a href="http://johnmacfarlane.net/pandoc/">Pandoc</a></li>
<li><a href="https://github.com/astefanutti/decktape">DeckTape</a></li>
</ul></li>
<li>Descargado automáticamente:
<ul>
<li><a href="http://lab.hakim.se/reveal-js/#/">Reveal.js</a></li>
</ul></li>
</ul>
<h2 id="requisitos"><span class="header-section-number">2.2</span> Requisitos</h2>
<p>Por ahora, solo funciona en Linux (y puede que en MacOS).</p>
<p>Puede funcionar con Docker, pero todavía está en pruebas.</p>
<h2 id="descarga"><span class="header-section-number">2.3</span> Descarga</h2>
<p><a href="https://github.com/asanzdiego/markdownslides/archive/master.zip">github.com/asanzdiego/markdownslides/archive/master.zip</a></p>
<h2 id="docker"><span class="header-section-number">2.4</span> Docker</h2>
<p>Su instalación con docker está todavía <strong>en pruebas</strong>.</p>
<p>Cualquier feedback es bienvenido.</p>
<h3 id="construir-la-imagen"><span class="header-section-number">2.4.1</span> Construir la imagen</h3>
<p>Estará en Dockerhub pronto:</p>
<pre><code>$ docker build -t asanzdiego/markdownslides .</code></pre>
<h3 id="lanzar-el-contenedor"><span class="header-section-number">2.4.2</span> Lanzar el contenedor</h3>
<p>Lanzamos el contenedor con la configuración <strong>min</strong></p>
<pre><code>docker run -it -v ${PWD}/doc:/home/markdownslides/doc \
    asanzdiego/markdownslides</code></pre>
<p>Cambiando a configuración <strong>med</strong></p>
<pre><code>docker run -it -v ${PWD}/doc:/home/markdownslides/doc \
    asanzdiego/markdownslides ./build.sh med doc</code></pre>
<p>Cambiando a configuración <strong>max</strong></p>
<pre><code>docker run -it -v ${PWD}/doc:/home/markdownslides/doc \
    asanzdiego/markdownslides ./build.sh max doc</code></pre>
<h1 id="manejo"><span class="header-section-number">3</span> Manejo</h1>
<h2 id="creación"><span class="header-section-number">3.1</span> Creación</h2>
<p>Primero <strong>copia la carpeta doc y renombrala a tu gusto</strong>. Esto no es necesario pero te ayuda a organizar tus documentos.</p>
<p><strong>Crea los ficheros md</strong> que quieras generar en la <strong>carpeta md</strong>. Los ficheros md son ficheros <a href="http://es.wikipedia.org/wiki/Markdown">Markdown</a>, que no son nada más que ficheros de texto plano, con extensión md, y con un marcado ligero (que hay que conocer pero que es muy sencillo).</p>
<h2 id="notas"><span class="header-section-number">3.2</span> Notas</h2>
<p>Puedes añadir notas que serán visibles en modo libro o si <strong>pulsas la letra 's' en las slides</strong> mediante <strong><span class="citation" data-cites="start-notes">@start-notes</span></strong> y <strong><span class="citation" data-cites="end-notes">@end-notes</span></strong>.</p>
<pre><code>
Esto solo es visible en modo libro o si pulsas &#39;s&#39; en las slides.
 </code></pre>
<p>Esto solo es visible en modo libro o si pulsas 's' en las slides.</p>
<h2 id="niveles"><span class="header-section-number">3.3</span> Niveles</h2>
<p>Puedes tener tantos niveles como quieras. Ejemplo:</p>
<pre><code># Nivel 1 (en slides y libro)

## Nivel 2 (en slides y libro)

### Nivel 3 (en libro pero se queda como nivel 2 en slides) </code></pre>
<p>Pero sólo en los libros. En las slides solo puedes tener 2 niveles.</p>
<h2 id="numeración"><span class="header-section-number">3.4</span> Numeración</h2>
<pre><code>## Foo Bar

</code></pre>
<p>En el libro quedará:</p>
<pre><code>## Foo Bar</code></pre>
<h2 id="configuración"><span class="header-section-number">3.5</span> Configuración</h2>
<p>Podemos configurar los ficheros que queremos generar desde el fichero <strong>build.properties</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="co">#GENERATION_MODE=&#39;min|med|max&#39;</span>
<span class="va">DEFAULT_GENERATION_MODE=</span><span class="st">&#39;min&#39;</span>

<span class="va">BUILD_REVEAL_SLIDES=</span><span class="st">&#39;min&#39;</span>
<span class="va">BUILD_REVEAL_SLIDES_PDF=</span><span class="st">&#39;med&#39;</span>

<span class="va">BUILD_HTML_BOOK=</span><span class="st">&#39;max&#39;</span>
<span class="va">BUILD_DOCX_BOOK=</span><span class="st">&#39;max&#39;</span>
<span class="va">BUILD_EPUB_BOOK=</span><span class="st">&#39;max&#39;</span></code></pre></div>
<p>Podemos configurar también algunas cosas más desde el fichero <strong>build.properties</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="va">CLEAN_LIB_FOLDER=</span><span class="st">&#39;no&#39;</span>
<span class="va">COPY_IMG_FOLDER=</span><span class="st">&#39;no&#39;</span>
<span class="va">ZIP_EXPORT_FOLDER=</span><span class="st">&#39;no&#39;</span>
<span class="va">NUMBER_SECTIONS=</span><span class="st">&#39;yes&#39;</span>
<span class="va">NUMBER_OFFSET=</span><span class="st">&#39;no&#39;</span>
<span class="va">CURRENT_NUMBER_OFFSET=</span>1
<span class="va">REMOVE_MD_TO_BOOK=</span><span class="st">&#39;yes&#39;</span>
<span class="va">REMOVE_MD_TO_SLIDES=</span><span class="st">&#39;yes&#39;</span></code></pre></div>
<p>Podemos configurar también algunas cosas más sobre reveal.js desde el fichero <strong>build.properties</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="co">#THEME=&#39;black|white|league|sky|beige|simple|serif|blood|night|moon|solarized&#39;</span>
<span class="va">REVEAL_JS_THEME=</span><span class="st">&#39;beige&#39;</span>
<span class="va">REVEAL_JS_SHOW_TITLE_FOOTER=</span><span class="st">&#39;yes&#39;</span>
<span class="va">REVEAL_JS_DEFAULT_TITLE_FOOTER=</span><span class="st">&#39;yes&#39;</span>
<span class="va">REVEAL_JS_TITLE_FOOTER=</span><span class="st">&quot;&#39;MarkdownSlides by @asanzdiego :-)&#39;&quot;</span>
<span class="va">REVEAL_JS_URL=</span><span class="st">&#39;../lib/reveal.js/&#39;</span>
<span class="va">REVEAL_JS_MENU_URL=</span><span class="st">&#39;../lib/reveal.js-menu/&#39;</span>
<span class="va">REVEAL_JS_TITLE_FOOTER_URL=</span><span class="st">&#39;../lib/reveal.js-title-footer/&#39;</span></code></pre></div>
<h2 id="generación"><span class="header-section-number">3.6</span> Generación</h2>
<p>Hay que posicionarse en la carpeta raiz, y ejecutar:</p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="ex">./build.sh</span> [clean] [modo] [carpeta]</code></pre></div>
<ul>
<li><p>[<strong>clean</strong>] limpia la carpeta <strong>lib</strong> y vuelve a a bajar las dependencias.</p></li>
<li><p>[<strong>modo</strong>] puede tomar los valores: <strong>min, med o máx</strong>.</p></li>
<li><p>[<strong>carpeta</strong>] donde va a buscar los ficheros md. Si no se indica nada convertirá todos los ficheros md de todas las carpetas.</p></li>
</ul>
<h1 id="releases-notes"><span class="header-section-number">4</span> Releases notes</h1>
<h2 id="relese-1.0"><span class="header-section-number">4.1</span> Relese 1.0</h2>
<ul>
<li><p>Exporta slides a:</p>
<ul>
<li>reveal-slides</li>
<li>reveal-slides-pdf</li>
<li>beamer-slides</li>
<li>deck-slides</li>
</ul></li>
<li><p>Exporta books a:</p>
<ul>
<li>html-book</li>
<li>docx-book</li>
<li>odt-book</li>
<li>pdf-book</li>
</ul></li>
<li>Añadidos los modos de generación 'min', 'med' y 'max'.</li>
<li><p>Descarga automática de librerías externas.</p></li>
</ul>
<h2 id="relese-2.0"><span class="header-section-number">4.2</span> Relese 2.0</h2>
<ul>
<li><p>Exporta slides a:</p>
<ul>
<li>reveal-slides</li>
<li>reveal-slides-pdf</li>
<li>reveal-slides-online</li>
</ul></li>
<li><p>Exporta books a:</p>
<ul>
<li>html-book</li>
<li>docx-book</li>
<li>epub-book</li>
</ul></li>
<li><p>Deprecated:</p>
<ul>
<li>beamer-slides</li>
<li>deck-slides</li>
<li>odt-book</li>
<li>pdf-book</li>
</ul></li>
<li>Añadido menú gracias a <a href="https://github.com/hhkaos">Raúl Jimenez Ortega</a></li>
<li>Añadido dockerfile gracías a <a href="https://github.com/kaneproject">Rubén Gómez García</a></li>
<li>Limpieza de ficheros zip de las librerías gracias a <a href="https://github.com/cesarseoane">Cesar Seoane</a></li>
<li>Añadido tipo 'online' gracias a <a href="https://github.com/cesarseoane">Cesar Seoane</a></li>
<li>Arreglado fallo imágenes HTTPS gracias a <a href="https://github.com/cesarseoane">Cesar Seoane</a></li>
<li>Carga de librerias 'online' por HTTPS gracias a <a href="https://github.com/cesarseoane">Cesar Seoane</a></li>
<li><p>Configuración resolución PDF gracias a <a href="https://github.com/cesarseoane">Cesar Seoane</a></p></li>
<li>Nuevo formato 'epub'.</li>
<li>Añadido 'bash strict mode'.</li>
<li>Añadido 'build.properties' para configurar la generación de ficheros.</li>
<li>Añadido comando 'clean' para limpiar la carpeta lib.</li>
<li>Descarga de una versión concreta de librería externa.</li>
<li>Añadidas notas solo visibles en modo libro o si pulsas 's' en las slides.</li>
<li><p>Normalización de imágenes en slides.</p></li>
</ul>
<h2 id="relese-3.0"><span class="header-section-number">4.3</span> Relese 3.0</h2>
<ul>
<li>Limpieza de código.</li>
<li>Eliminada la exportación de archivos &quot;deprecated&quot;.</li>
<li>Mejora de la configuración en el fichero build.properties.</li>
<li>Actualización de las dependencias de <a href="http://lab.hakim.se/reveal-js/#/">Reveal.js</a>.</li>
<li>Exportación a PDF con <a href="https://github.com/astefanutti/decktape">DeckTape</a>.</li>
</ul>
<h1 id="autor"><span class="header-section-number">5</span> Autor</h1>
<h2 id="adolfo-sanz-de-diego"><span class="header-section-number">5.1</span> Adolfo Sanz De Diego</h2>
<ul>
<li><p>Empecé <strong>desarrollando aplicaciones web</strong>, hasta que di el salto a la docencia.</p></li>
<li><p>Actualmente soy <strong>Asesor Técnico Docente</strong> en el servicio TIC de la D.G de Infraestructuras y Servicios de la Consejería de Educación, Juventud y Deporte de la Comunidad de Madrid.</p></li>
<li><p>Además colaboro como <strong>formador especializado en tecnologías de desarrollo</strong>.</p></li>
</ul>
<h2 id="algunos-proyectos"><span class="header-section-number">5.2</span> Algunos proyectos</h2>
<ul>
<li><p><img src="../img/hackathon-lovers-logo.png" alt="Hackathon Lovers" height="30" /> <a href="http://hackathonlovers.com">Hackathon Lovers</a>: un grupo creado para emprendedores y desarrolladores amantes de los hackathones.</p></li>
<li><p><a href="http://pasmangen.github.io">Password Manager Generator</a>: un gestor de contraseñas online.</p></li>
<li><p><a href="https://github.com/asanzdiego/markdownslides">MarkdownSlides</a>: un script para crear slides a partir de ficheros MD.</p></li>
</ul>
<h2 id="donde-encontrarme"><span class="header-section-number">5.3</span> ¿Donde encontrarme?</h2>
<ul>
<li><p>Mi nick: <strong>asanzdiego</strong></p>
<ul>
<li>Blog: <a href="http://asanzdiego.com">asanzdiego.com</a></li>
<li>GitHub: <a href="http://github.com/asanzdiego">github.com/asanzdiego</a></li>
<li>Twitter: <a href="http://twitter.com/asanzdiego">twitter.com/asanzdiego</a></li>
<li>LinkedIn: <a href="http://www.linkedin.com/in/asanzdiego">linkedin.com/in/asanzdiego</a></li>
<li>SlideShare: <a href="http://www.slideshare.net/asanzdiego">slideshare.net/asanzdiego</a></li>
</ul></li>
</ul>
</body>
</html>
